home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / web / fweb / fweb-1.40 / boot / misc / READ_ME.MISC < prev   
Text File  |  1993-10-29  |  3KB  |  59 lines
  1.                  --- The VOID ---
  2.                    Version 1.30
  3.                    May 15, 1993
  4.  
  5.    This subdirectory contains vanilla-flavored bootstrap files for bringing
  6. FWEB up on an unknown machine that is specifically NOT fully ANSI-compatible.
  7.  
  8.    See READ_ME.FWEB for a description of the files and for instructions on
  9. using the make facility. 
  10.  
  11.    To bootstrap, please see the instructions in READ_ME.FWEB.
  12.  
  13.    When bringing FWEB up on a new machine, you should have a minimum of
  14. difficulties if your compiler is fully ANSI. If it is, you should NOT be
  15. using the code here; try the ./configure procedure described in
  16. READ_ME.FWEB, or use the code in boot/unix/ansi/. However, if it is
  17. not, try beginning with this code.  You may encounter one or more of the
  18. following difficulties:
  19.  
  20. * DIFFICULTIES WITH FUNCTION PROTOTYPING. New with the ANSI standard is the
  21. concept of function prototyping; the ``old-style'' of declarations is
  22. allegedly obsolete. The FWEB source code is macroed up in such a way that
  23. bootstrap code with or without function prototyping can be generated. The
  24. MISC code uses no function prototypes and old-style declarations, so you're
  25. probably safe here.
  26.  
  27. * MISSING HEADER FILES. One of the great services the ANSI standard
  28. provided was to standarize the headers and library routines. You may have
  29. to scrounge around to find your system's versions of the proper header
  30. files, or in some cases declare certain library routines yourself.  The
  31. custom.h template that is provided uses ANSI includes as a start.
  32.  
  33. * MISSING LIBRARY ROUTINES. See the above remark. You might have to write a
  34. few replacement routines.  If so, please let me know what they were.
  35.  
  36. * PROBLEMS WITH SIGNED VS. UNSIGNED, or LONG VS. INT.  Considerable effort
  37. has been made to get a consistent and portable set of data types. Working
  38. with 16-bit arithmetic on the Mac and IBM-PC exposed a variety of
  39. difficulties, many inherited from previous authors. These may not all be
  40. fixed. It's best to work with 32-bit ints if you can. Otherwise, watch out
  41. for the arithmetic.  If you're working with 16 bit arithmetic, definitely
  42. start with boot/ibm/pc/custom.h rather than boot/misc/custom.h.
  43.  
  44. * PROBLEMS WITH MEMORY ALLOCATION. In some cases, very long arrays must be
  45. allocated. Be sure calloc (see the get_mem0 function in common.web) can
  46. handle the arguments it's being given.
  47.  
  48. * PROBLEMS WITH THE IMPLEMENTATION OF THE TIMING ROUTINES. Again, ANSI
  49. standardized all this, but not everybody's caught up.
  50.  
  51.    The machine-specific code is localized in the C header file os.h, which
  52. #includes custom.h, then does a few more things.  In a pinch, you could edit
  53. os.h as well as custom.h.  However, if you do, please let me know.
  54.  
  55.                 *       *       *
  56.  
  57.    Please keep a careful list of all bugs and fixes, and report them.
  58. Thanks. 
  59.